home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / dev / src / stefanb_src.lha / Old_Projects / UMSUUCP / ums_uucp.doc < prev   
Encoding:
Text File  |  1993-12-02  |  27.5 KB  |  736 lines
  1. UMS UUCP V0.8                                                 01-Dec-1993
  2.  
  3.  
  4. Disclaimer
  5. ----------
  6.  
  7.    Permission is granted to make and distribute verbatim copies  of  this
  8. manual provided the copyright  notice  and  this  permission  notice  are
  9. preserved on all copies.
  10.  
  11. COPYRIGHT
  12.  
  13.    Copyright (C) 1992-93 Stefan Becker
  14.  
  15.    No program, document, data file or  source  code  from  this  software
  16. package, neither in whole nor in part, may be included or used  in  other
  17. software packages unless it is authorized by a  written  permission  from
  18. the author.
  19.  
  20.  
  21. NO WARRANTY
  22.  
  23.    There is no warranty for this software package.  Although  the  author
  24. has tried to prevent errors, he can't guarantee that the software package
  25. described in this document is 100% reliable. You are therefore using this
  26. material at your own risk. The author cannot be made responsible for  any
  27. damage which is caused by using this software package.
  28.  
  29.  
  30. DISTRIBUTION
  31.  
  32.    This software package is freely distributable. It may be  put  on  any
  33. media which is used for the distribution of free  software,  like  Public
  34. Domain disk collections, CDROMs, FTP servers or bulletin board systems.
  35.  
  36.    In  order  to  ensure  the  integrity  of   this   software   package,
  37. distributors should use the original  archive  file  umsuucp0_8.lha.  The
  38. author cannot be made responsible if this  software  package  has  become
  39. unusable due to modifications of the archive contents or of  the  archive
  40. file itself.
  41.  
  42.    There is no limit on the costs  of  the  distribution,  e.g.  for  the
  43. media, like floppy disks, streamer tapes or compact disks, or the process
  44. of duplicating. Such limits have been proven to be harmful to the idea of
  45. freely distributable software, e.g. instead of reducing the price of  the
  46. floppy disk below the limit, the software was  simply  removed  from  the
  47. master disk.
  48.  
  49.    Although the author does not impose any limit on the  distribution  of
  50. this software package, he would like to express his personal opinions  on
  51. this matter:
  52.  
  53.    * This software package should be made available to everyone  free  of
  54.      charge whenever it is possible.
  55.  
  56.    * If you have acquired this software package under  normal  conditions
  57.      from a Public Domain dealer on a floppy disk at a price higher  than
  58.      5DM or US $5, then you have definitely paid too much.  Please  don't
  59.      support this improper profit making  any  longer  and  switch  to  a
  60.      cheaper source as soon as possible.
  61.  
  62.  
  63. USAGE RESTRICTIONS
  64.  
  65.    No program, document, data file or  source  code  from  this  software
  66. package, neither in whole nor in part, may be used on any  machine  which
  67. is used
  68.  
  69.    * for the research, development, construction, testing  or  production
  70.      of weapons or other military applications. This  also  includes  any
  71.      machine which is  used  in  the  education  for  any  of  the  above
  72.      mentioned purposes.
  73.  
  74.    * by people who accept, support or use violence against other  people,
  75.      e.g. citizens from foreign countries.
  76.  
  77.  
  78. Introduction
  79. ------------
  80.  
  81. This is an UUCP importer/exporter package for UMS V10.  It  contains  all
  82. binaries and documentation to run a minimum UUCP node with  UMS.  If  you
  83. need more features, please get the AmigaUUCP 1.16 or the  wUUCP  package.
  84. You only need to replace the uuxqt binary in that package  with  the  UMS
  85. UUCP uuxqt.
  86.  
  87. If you already have an UUCP node running, you may use the scripts in  the
  88. "convert" directory to import the mail/news articles  into  the  new  UMS
  89. message base. If you are using AmigaUUCP or wUUCP  you  can  recycle  the
  90. configuration files.
  91.  
  92.  
  93. Archive contents
  94. ----------------
  95.  
  96.     Directory: bin - Binaries
  97.  
  98.         compress    Compression program
  99.                     (fast & acceptable compression ratio)
  100.         freeze      Compression program
  101.                     (slow & good compression ratio)
  102.         gzip        Compression program
  103.                     (fast & good compression ratio)
  104.  
  105.         ums2uucp    UMS UUCP Exporter
  106.         uuxqt       UMS UUCP Importer
  107.         testaddress Test program for UUCP addresses
  108.  
  109.         uucico      UUCP file transfer program
  110.         uucico116a  UUCP file transfer program
  111.                     (advanced features like XferStat)
  112.  
  113.     Directory: convert - Scripts to import  existing  news/mail  articles
  114.                          into an UMS message base
  115.  
  116.     Directory: docs - Documentation for  the  enclosed  UUCP  programs  &
  117.                       files
  118.  
  119.     Directory: lib - UUCP configuration files
  120.  
  121.         config      Node configuration
  122.         L.sys       Information about remote systems
  123.         security    Access rights for up- and download
  124.         seq         Sequence number for UUCP jobs
  125.  
  126.     Directory: libs
  127.  
  128.         OwnDevUnit.library  Copy this file to LIBS:
  129.  
  130.  
  131. Information about your UUCP node
  132. --------------------------------
  133.  
  134. Each UUCP node has a name. This name must not be longer than 7 characters
  135. and may only contain lowercase characters,  e.g.  "foobar".  Additionally
  136. you need to know in  which  domain  your  node  will  reside.  With  this
  137. information  you  can  build  the  domain  name  of   your   node,   e.g.
  138. "foobar.earth.sol.galaxy".
  139.  
  140. This   information   is   stored   in   the    configuration    variables
  141. "uucp.nodename", "uucp.domainname" and  "uucp.pathname".  Look  into  the
  142. section "Configuration variables" for more information.
  143.  
  144.  
  145. UUCP Node setups
  146. ----------------
  147.  
  148. A UUCP node can be set up in three different ways:
  149.  
  150.     - Leaf node
  151.  
  152.         A leaf node is the last system on the message distribution chain.
  153.         Such a node imports messages from one or more remote systems, but
  154.         doesn't export  those  messages  to  other  systems.  Only  local
  155.         messages are exported to the remote systems.  Most  users  should
  156.         use this mode, because it's very easy to maintain.
  157.  
  158.         UMS behaves like a leaf node, when the UMS configuration variable
  159.         "FullNode" is set to 0.
  160.  
  161.     - Full node
  162.  
  163.         A full node is located inside the message distribution chain.  It
  164.         imports messages from remote systems and exports  them  to  other
  165.         remote systems. The maintainer of such a system must control  the
  166.         message flow between the  systems  very  carefully  in  order  to
  167.         prevent loops and  duplicate  messages.  Only  experienced  users
  168.         should use this mode.
  169.  
  170.         UMS behaves like a full node, when the UMS configuration variable
  171.         "FullNode" is set to 1. The message flow between the  systems  is
  172.         controlled with the variables "readaccess" and "export".
  173.  
  174.     - Gateway
  175.  
  176.         A gateway behaves like a  full  node,  but  additionally  it  can
  177.         distribute messages between UUCP and non RFC compliant nets. Such
  178.         systems are very delicate to handle, can cause many headaches and
  179.         create many enemies and flame wars. Only  VERY  VERY  experienced
  180.         users should use this mode. You have been warned!
  181.  
  182.         UMS behaves like a gateway, when the UMS  configuration  variable
  183.         "FullNode" is set to 1 and the variable "GateKey"  is  set  to  a
  184.         valid  key.  Please  contact  <mh@umshq.dfv.rwth-aachen.de>   for
  185.         further information on the key.
  186.  
  187.  
  188. User entries for UUCP
  189. ---------------------
  190.  
  191. Every user who wants to write messages that will  be  exported  via  UUCP
  192. needs a UMS config variable "uucp.username". This variable  contains  the
  193. "account" name for the user, e.g. "jduser" for the user "Joe Dumb  User".
  194. The UUCP address for such a user will be "jduser@<domain>". In  order  to
  195. receive messages under this name, it should be added as an alias  to  his
  196. user entry.
  197.  
  198. Every UUCP node has a  special  user,  called  the  postmaster.  He  will
  199. receive all error messages from the UUCP system. If you have choosen  the
  200. user, who will be the postmaster, add the alias "postmaster" to his  user
  201. entry.
  202.  
  203.  
  204. Node entries for other systems
  205. ------------------------------
  206.  
  207. For each system, which exchanges mails and news with your node, you  must
  208. create a user entry. The name of this user consists of the prefix "uucp."
  209. and the system name, e.g. "uucp.foobar". One system must be  assigned  to
  210. be the default  system  for  UUCP,  for  which  you  must  add  an  alias
  211. "uucp.default" to the user entry.
  212.  
  213. With the entry "writeaccess" you can control the import of news messages.
  214. Only  messages  in  groups  whose  names  match  the   pattern   of   the
  215. "writeaccess" entry will be written to the message base. This can be used
  216. to avoid the creation of unwanted groups through crosspostings.
  217.  
  218. The entries "readaccess" and "distribution" control the  export  of  news
  219. messages. Only messages whose distribution field matches the  pattern  in
  220. the "distribution" entry and whose group names match the pattern  of  the
  221. "readaccess" entry are exported.
  222.  
  223. The entries "import" and "export" are the corresponding entries for  mail
  224. messages. The  patterns  from  these  entries  are  matched  against  the
  225. recipient address. The "export" entry can be used  to  channel  the  mail
  226. messages flow through different systems.
  227.  
  228.  
  229. Data file formats
  230. -----------------
  231.  
  232. Several formats are used  for  UUCP  data  files.  The  messages  can  be
  233. transfered as single files. Only mails  are  transfered  in  this  format
  234. nowadays, because  small  files  degrade  the  performance  of  the  file
  235. transfer.
  236.  
  237. This can be avoided, if a data file contains several messages. This  file
  238. format is called "batch file". News articles can simply  be  concatenated
  239. into one file, because they already contain the  message  length  in  the
  240. header. For mails an adaption of the SMTP format is used, called "Batched
  241. SMTP" (BSMTP).
  242.  
  243. To reduce the amount of data which needs to be transfered, batched  files
  244. are usually compressed. Currently in use are three compression  programs:
  245. compress, freeze and gzip.  Normally  only  the  plain  output  of  those
  246. programs is stored in the data file,  but  compressed  news  batches  can
  247. addtionally contain  a  small  plaintext  header,  which  identifies  the
  248. compression program.
  249.  
  250. Every incoming command file contains a command line, which tells the UUCP
  251. system, what to do with the corresponding data file. The  importer  uuxqt
  252. doesn't use the supplied command name, because it interprets the contents
  253. of  the  data  file.  The  compression  type  and  the  batch  mode   are
  254. automatically detected.
  255.  
  256. The exporter ums2uucp can create any command line format and headers  for
  257. outgoing  data   files.   The   two   variables   "uucp.mailexport"   and
  258. "uucp.newsexport" specify the  format.  For  the  exact  syntax  of  this
  259. variables look into the section "Configuration variables".
  260.  
  261.  
  262. Layout of the spool directory
  263. -----------------------------
  264.  
  265. UMS UUCP supports two different layouts of the spool directory: plain and
  266. hierarchic.
  267.  
  268. The plain layout is used by AmigaUUCP. All in- and outgoing files can  be
  269. found in the spool directory. This is sufficient  for  small  nodes  with
  270. only one host. Note that the uucico binaries supplied  with  the  package
  271. only support the plain layout.
  272.  
  273. The hierarchic layout is used by wUUCP. For every system a directory with
  274. the name of the system is created, e.g. "UUSPOOL:foobar" for  the  system
  275. "foobar". All in- and outgoing files for this system can be found in that
  276. directory. If the corresponding directory can't be found, then the  plain
  277. layout is used. This layout is more  efficient  for  nodes  with  several
  278. hosts. Note that you need a special uucico to use this layout.
  279.  
  280. If a job has an error, UMS UUCP doesn't delete it, but marks it.  If  you
  281. create a directory "bad-jobs" in the spool dir, then the command and  the
  282. data file of the job will be moved into this directory.  If  this  fails,
  283. e.g. the directory doesn't exist, then only the command file  is  renamed
  284. from "X.*" to "E.*" to prevent the execution of  this  job  in  the  next
  285. uuxqt run.
  286.  
  287.  
  288. UMS configuration variables
  289. ---------------------------
  290.  
  291. All UMS variables used by the UUCP programs have the prefix "uucp.", e.g.
  292. "uucp.pathname".  Local  variables  in  a  user  entry  override   global
  293. variables. With this in mind, you should create  a  global  variable  for
  294. every setting with the default value. Now you can override  this  default
  295. value with a local variable in the user entry.
  296.  
  297. Here is a list of all variables:
  298.  
  299.   debugfile  (string)
  300.  
  301.     Output file for error logs. Useful only for debugging.
  302.  
  303.   debuglevel (number)
  304.  
  305.     Set the highest log level. Messages  with  a  higher  level  are  not
  306.     logged. Useful only for debugging.
  307.  
  308.   domainname (string)
  309.  
  310.     The domainname for your system, e.g. foobar.earth.sol.galaxy
  311.  
  312.   dumbhost   (Y or N)
  313.  
  314.     Set this to "Y" when a host requires RFC976 style UUCP mail envelopes.
  315.  
  316.         Normal envelopes: From <user>@<domain> <date>
  317.         RFC976 envelopes: From <user> <date> remote from <domain>
  318.  
  319.   encoding   (string)
  320.  
  321.     This sets the contents encoding  type  for  MIME.  Legal  values  are
  322.     "8bit" or "binary". Normally you should use  "8bit",   but   if   you
  323.     can't assure that the line length is always smaller than  1000,  then
  324.     use "binary".
  325.  
  326.   export.*   (string)
  327.  
  328.     This sets the domain names for exporting  messages  out  of  non  RFC
  329.     compliant nets. Currently defined are the following  variables  (with
  330.     their defaults):
  331.  
  332.         FTN (FIDO):     uucp.export.fido = .fidonet.org
  333.         Mausnetz  :     uucp.export.maus = .maus.de
  334.         Z-Netz    :     uucp.export.zer  = .zer.sub.org
  335.  
  336.   import.*   (string)
  337.  
  338.     This sets the domain names which the  importer  should  recognize  as
  339.     messages from non  RFC compliant  nets.  Currently  defined  are  the
  340.     following variables (with their defaults):
  341.  
  342.         FTN (FIDO):     uucp.import.fido = .fidonet.org
  343.         Mausnetz  :     uucp.import.maus = .maus.de
  344.         Z-Netz    :     uucp.import.zer  = .zer.sub.org
  345.  
  346.     You can specify several domain names by seperating them with ",". The
  347.     address conversion between RFC and UMS is explained  in  the  section
  348.     "Advanced Information".
  349.  
  350.   keepdupes  (Y or N)
  351.  
  352.     Normally duplicate messages are flagged as error and the job  is  not
  353.     deleted. Sometimes dupes can't be avoided, because UUCP is an offline
  354.     protocol, that means there is no way to detect dupes on  the  sending
  355.     hosts. On a system with several  hosts  and  high  traffic  this  can
  356.     result in a high number of bad job files lying around, which  do  not
  357.     contain real errors. If you set this variable to "N" then  bad  jobs,
  358.     which had only dupe errors, are automatically deleted.
  359.  
  360.   mailexport (string)
  361.  
  362.     This variable specifies, in which  format  mail  messages  should  be
  363.     exported. The syntax is the same as for "newsexport".
  364.  
  365.   mailroute  (string, multi-line)
  366.  
  367.     Sometimes it's important to specify static routes for outgoing mails.
  368.     Normally this variable is empty so NO  routing  information  will  be
  369.     generated. Each line in this variable consists of an address  pattern
  370.     and a list of hosts:
  371.  
  372.       <address pattern> [<host1>[,<host2>....]]
  373.  
  374.     When the recipient address matches the address pattern and  the  host
  375.     list is not empty, then the exporter ums2uucp will create an explicit
  376.     mail route. The route information will be  added  AFTER  the  address
  377.     conversion for non RFC compliant nets has been applied.
  378.  
  379.     If the variable does contain several lines, then the patterns will be
  380.     tried from the first line down to the last  line  until  one  pattern
  381.     matches. If no pattern matches, then no  route  information  will  be
  382.     generated.
  383.  
  384.     Example:
  385.  
  386.         uucp.mailroute = "#?.maus.de    host1
  387.         #?.zer.sub.org                  host2,host3
  388.         #?.fidonet.org
  389.         #?.de                           host4"
  390.  
  391.     Test cases:
  392.  
  393.         user@box.maus.de
  394.         user@box.zer.sub.org
  395.         user@f7.n242.z2.fidonet.org
  396.         user@zauber.nase.de
  397.         user@dummy.blubb.edu
  398.  
  399.     These will be transformed to the following mail routes:
  400.  
  401.         - RMail:    C rmail host1!box.maus.de!user
  402.                     C rmail host2!host3!box.zer.sub.org!user
  403.                     C rmail user@f7.n242.z2.fidonet.org
  404.                     C rmail host4!zauber.nase.de!user
  405.                     C rmail user@dummy.blubb.edu
  406.  
  407.         - BSMTP:    RCPT TO: <@host1:user@box.maus.de>
  408.                     RCPT TO: <@host2,@host3:user@box.zer.sub.org>
  409.                     RCPT TO: <user@f7.n242.z2.fidonet.org>
  410.                     RCPT TO: <@host4:user@zauber.nase.de>
  411.                     RCPT TO: <user@dummy.blubb.edu>
  412.  
  413.   newsexport (string)
  414.  
  415.     This variable specifies, in which  format  news  articles  should  be
  416.     exported. The syntax is as follows:
  417.  
  418.         <command>[,<batch>[,<compress command>[,<header>[,<max size>]]]]
  419.  
  420.     command - Command name for the "C" line  in  the  command  file. You
  421.               have to talk to  your  host  which  commands  his  software
  422.               accepts and how it interprets  them.  The  following  table
  423.               shows some common names:
  424.  
  425.                  Name    | Meaning
  426.                 -----------------------------------------------
  427.                  rmail   | unbatched, uncompressed mail
  428.                  rbsmtp  | batched, uncompressed mail
  429.                  rcbsmtp | batched, compressed (compress) mail
  430.                  rbcsmtp | batched, compressed (compress) mail
  431.                  rfbsmtp | batched, compressed (freeze) mail
  432.                  rbfsmtp | batched, compressed (freeze) mail
  433.                  rgbsmtp | batched, compressed (gzip) mail
  434.                  rbgsmtp | batched, compressed (gzip) mail
  435.                  rnews   | (un)batched, (un)compressed news
  436.  
  437.     batch (Y or N) - Batch messages (Default: No)
  438.  
  439.     compress command - Name of the compression command (Default: None)
  440.                        Legal values are: <None>, compress, freeze or gzip
  441.  
  442.     header - Data file header (Default: None)
  443.              If this field  is  not  empty,  then  the  following  header
  444.              line will be created in the data file:
  445.  
  446.                 "#! <header text>"
  447.  
  448.              The following table shows some common header texts:
  449.  
  450.                  Name    | Meaning
  451.                 ------------------------------------------------
  452.                 cunbatch | batched, compressed (compress) news
  453.                 funbatch | batched, compressed (freeze) news
  454.                 gunbatch | batched, compressed (gzip) news
  455.  
  456.     max size (number) - Number of bytes for one batch
  457.                         (Default: 65536 Bytes)
  458.  
  459.    Examples:
  460.  
  461.     - unbatched, uncompressed mail:
  462.  
  463.         uucp.mailexport=rmail
  464.  
  465.     - batched, uncompressed mail, no header, batch size 65536 Bytes:
  466.  
  467.         uucp.mailexport=rbsmtp,Y
  468.  
  469.     - batched, compressed mail, no header, batch size 300000 Bytes:
  470.  
  471.         uucp.mailexport=rcbsmtp,Y,compress,,300000
  472.  
  473.     - batched, uncompressed news, no header, batch size 300000 Bytes:
  474.  
  475.         uucp.newsexport=rnews,Y,,,300000
  476.  
  477.     - batched, compressed news, with header (#! cunbatch), batch size
  478.       65536 Bytes:
  479.  
  480.         uucp.newsexport=rnews,Y,compress,cunbatch
  481.  
  482.   nodename   (string)
  483.  
  484.     UUCP Node name for your system, e.g. foobar. This name should not  be
  485.     longer than 7 characters.
  486.  
  487.   pathname   (string)
  488.  
  489.     The name of your system in the "Path:" line  for  news  articles.  If
  490.     your system is a registered UUCP node, then set this variable to  the
  491.     contents of the variable "nodename", otherwise to the contents of the
  492.     variable "domainname".
  493.  
  494.         Registered node    : foobar
  495.         Not registered node: foobar.earth.sol.galaxy
  496.  
  497.   username   (string)
  498.  
  499.     This is the "account" name for a user, e.g. joedumb. Every  UMS  user
  500.     who wants to use UUCP news & mail MUST have this variable in his user
  501.     entry. The address of this user will be <username>@<domainname>, e.g.
  502.     joedumb@foobar.earth.sol.galaxy.
  503.  
  504.  
  505. Environment variables
  506. ----------------------
  507.  
  508. Currently only one environment variable is used:
  509.  
  510.     UMSUUCP.mb (string) - Name of the UMS message base, e.g. test
  511.                           (Default: default message base)
  512.  
  513.  
  514. Command syntax
  515. --------------
  516.  
  517. Exporter: ums2uucp [-b<bit>] [-d<level>] -s<system>
  518.  
  519.     bit     : Bit number of an additional select bit (default:  0).  Only
  520.               messages with this bit  set  in  the  user  flags  will  be
  521.               exported. This can be used to run a special filter  program
  522.               before ums2uucp.
  523.     level   : Debug level for UUCP log messages (default: 0)
  524.     system  : Export messages for this system
  525.  
  526. Importer: uuxqt [-d<level>] [<system>]
  527.  
  528.     level   : Debug level for UUCP log messages (default: 0)
  529.     system  : Import messages from this system.  You  must  specify  this
  530.               parameter if you use   the   hierarchic   layout   of   the
  531.               spool directory.
  532.  
  533.  
  534. Log and error messages
  535. ----------------------
  536.  
  537. After processing, uuxqt writes the following messages  to  the  UUCP  log
  538. file:
  539.  
  540.     files (x/y) in (x/y) mail (x/y) news (x/y) cross (x/y)
  541.  
  542.         x       - Sum of all items (bad & good)
  543.         y       - Items with errors
  544.         files   - Processed command files. Files with errors are not
  545.                   deleted.
  546.         in      - Imported messages (in = mail + news + cross)
  547.         mail    - Imported mails
  548.         news    - Imported news articles
  549.         cross   - Crossposted  news  articles.  An  error  may  occur  in
  550.                   crossposting, when  the  importer  doesn't  have  write
  551.                   access to a group. This is not a  real  error,  because
  552.                   such messages are simply ignored.
  553.  
  554. Additional information about the errornous jobs will be written into  the
  555. error log, which will be sent to the user "postmaster".
  556.  
  557.  
  558. Example node setup
  559. ------------------
  560.  
  561. This section will describe a simple UUCP node setup with only one host to
  562. poll. Here is the list of information for our system:
  563.  
  564.     Account name    :   jduser
  565.     Node name       :   foobar
  566.     Domain name     :   foobar.earth.sol.galaxy
  567.     Registered Node :   No
  568.     UUCP Host       :   mars
  569.     UUCP login      :   Ufoobar
  570.     UUCP password   :   topsecret
  571.     Mail export     :   not batched, needs RFC976 envelopes
  572.     News export     :   batched, 100KB batches, use compress with header
  573.     Spool directory :   DH0:uucp/spool
  574.     UUPUB directory :   DH0:uucp/public
  575.     UULIB directory :   DH0:uucp/lib
  576.  
  577. Add these three assigns to S:user-startup:
  578.  
  579.     Assign UUSPOOL: DH0:uucp/spool
  580.     Assign UUPUB:   DH0:uucp/public
  581.     Assign UULIB:   DH0:uucp/lib
  582.  
  583. The spool directory will contain the in- and outgoing files (see  section
  584. "layout of the spool directory"). The UUPUB directory  does  contain  the
  585. public accessable files, which can  be  downloaded  via  UUCP  from  your
  586. system. The UULIB directory contains the UUCP configuration files.
  587.  
  588. Now follow the UUCP configuration  file  for  the  example  node.  For  a
  589. complete documentation of these files look  into  the  documentation  for
  590. AmigaUUCP.
  591.  
  592.     File:   UULIB:config
  593.  
  594.         NodeName    foobar
  595.         UserName    root
  596.         Debug       0
  597.  
  598.     File:   UULIB:L.sys
  599.  
  600.    # host          BPS   Dial cmd  Send-Expect Sequence
  601.    mars   Any SER: 19200 ATDP12345 ogin:-\r-ogin: Ufoobar ssword: topsecret\r
  602.  
  603.     File:   UULIB:sequrity
  604.  
  605.         UUPUB: rw
  606.  
  607. Add the following lines to your UMS configuration file:
  608.  
  609.     uucp.nodename   =   foobar
  610.     uucp.pathname   =   foobar.earth.sol.galaxy
  611.     uucp.domainname =   foobar.earth.sol.galaxy
  612.     uucp.mailexport =   rmail
  613.     uucp.dumbhost   =   Y
  614.     uucp.newsexport =   rnews,Y,compress,cunbatch,100000
  615.  
  616.     user
  617.         name            =   uucp.mars
  618.         writeaccess     =   #?
  619.         readaccess      =   #?
  620.         netaccess       =   #?
  621.         distribution    =   #?
  622.         import          =   #?
  623.         export          =   #?
  624.         alias           =   uucp.default
  625.     enduser
  626.  
  627. Add the following lines to your user entry:
  628.  
  629.     alias           =   postmaster
  630.     uucp.username   =   jduser
  631.  
  632. Now you can exchange news and  mail  with  the  system  "mars".  Use  the
  633. following commands to export messages for this system and to call it up:
  634.  
  635.     ums2uucp -smars
  636.     uucico -smars
  637.  
  638.  
  639. Advanced information
  640. --------------------
  641.  
  642. UMS itself is not a RFC system, which means that  all  messages  must  be
  643. transformed from the RFC format to the UMS format  and  vice  versa.  Not
  644. every piece of RFC information is used or stored by UMS, so the  importer
  645. must preserve the original information. All RFC header fields, which  are
  646. not known to the importer, are preserved.
  647.  
  648. There are two exceptions to this rule:
  649.  
  650.     - The order of  the  RFC  header  fields  is  not  always  preserved.
  651.       Luckily, the RFC standard does not impose a strict order  for  most
  652.       of the header fields.
  653.  
  654.     - If the message is a MIME message and the importer  can  decode  the
  655.       information, the exporter will not reconstruct the original message
  656.       text. Instead it will create new MIME headers which specify the new
  657.       format.
  658.  
  659. The exporter uses the additional information,  which  is  stored  by  the
  660. importer, to reconstruct the original messages.
  661.  
  662. Here are some examples, where preserving of the information is needed:
  663.  
  664.     - From/Reply-To
  665.  
  666.         These RFC fields contain the address and maybe the real  name  of
  667.         the user. Since this information is stored in two  seperates  UMS
  668.         fields,  these  lines  must  be  parsed  to  extract  the  needed
  669.         information. This parsing process is not reversible.
  670.  
  671.     - Newsgroups
  672.  
  673.         Crosspostings are stored as hard-linked messages, which appear in
  674.         different groups. But the importer for  a  system  may  not  have
  675.         write access to all groups  in  the  crossposting,  so  exporters
  676.         can't reconstruct this line by reading all hard-linked messages.
  677.  
  678.     - References
  679.  
  680.         UMS only uses one message ID for message threading.
  681.  
  682. Mapping of RFC fields to UMS fields:
  683.  
  684.   RFC header   | UMS fields                                  | Preserved
  685.   ----------------------------------------------------------------------
  686.   Control      | - (only cancel commands will be processed)  |   Yes
  687.   Date         | Date                                        |
  688.   Distribution | Distribution                                |
  689.   Followup-To  | ReplyGroup                                  |
  690.   From         | FromAddress & FromName (RFC1342-decoded)    |   Yes
  691.   In-Reply-To  | ReferID                                     |   Yes
  692.   Message-ID   | MessageID                                   |
  693.   Newsgroups   | Group (X messages hard linked)              |   Yes
  694.   Organization | Organization (RFC1342-decoded)              |
  695.   References   | ReferID (the last id in the header line)    |   Yes
  696.   Reply-To     | ReplyAddress & ReplyName (RFC1342-decoded)  |   Yes
  697.   Subject      | Subject (RFC1342-decoded)                   |
  698.   X-Mailer     | Newsreader                                  |
  699.   X-NewsReader | Newsreader                                  |
  700.   <all others> | Comment                                     |   Yes
  701.  
  702. Because UMS is a universal message system, some  messages  may  originate
  703. from a non RFC compliant net. The importer uuxqt tries to recognize  such
  704. messages and converts the RFC address to the UMS address format  for  the
  705. net. The exporter ums2uucp can export such messages and converts the  UMS
  706. address for the net into a RFC compliant address. The  following  address
  707. formats are supported:
  708.  
  709.     FTN (FIDO)
  710.  
  711.         - RFC       : <Real_Name>@[p<pnt>.]f<node>.n<hub>.z<zone><domain>
  712.         - UMS Name  : Real Name
  713.         - UMS Addr  : <zone>:<hub>/<node>[.<pnt>]@fidonet
  714.  
  715.     Mausnetz
  716.         - RFC       : <Real_Name>@<box><domain>
  717.         - UMS Name  : Real Name
  718.         - UMS Addr  : <box>.maus
  719.  
  720.     Z-Netz
  721.         - RFC       : <login>@<box><domain>
  722.         - UMS Addr  : <login>@<box>.zer
  723.  
  724. The domain part  for  import  and  export  can  be  controlled  with  the
  725. configuration variables "uucp.import.*" and "uucp.export.*".
  726.  
  727.  
  728. Contact address
  729. ---------------
  730.  
  731. The author (Stefan Becker) can be reached at the following addresses:
  732.  
  733.     stefanb@pool.informatik.rwth-aachen.de
  734.     stefanb@yello.adsp.sub.org
  735.  
  736.